home *** CD-ROM | disk | FTP | other *** search
/ Amiga News 95 / Amiga News 95.iso / dpat / dpat12 / pubselect / pubselect.doc < prev    next >
Text File  |  1992-10-21  |  8KB  |  249 lines
  1. *
  2. *
  3. * PubSelect version 1.00
  4. *   (c) 1992 par Stéphane Zermatten
  5. *   Ecrit au moyen de SAS/C 5.10a
  6. *
  7. * Ce programme est FreeWare
  8. * Il est librement distribuable
  9. * et doit toujours être accompagné de cette documentations.
  10. * Et des programmes CLI
  11. *
  12. ****************************************************************************
  13.  
  14. LISTING DU CONTENU
  15.  
  16.  
  17. SOMMAIRE
  18.  
  19.   I)    CE QU'EST PUBSELECT
  20.   II)    SUR CETTE DOCUMENTATION
  21.   III)    UTILISATION DE PUBSELECT
  22.     A.    Installation
  23.     B.    Les options
  24.     C.    Utilisation
  25.     D.    Quitter PubSelect
  26.   IV)    UTILISATION D'EXEPUB
  27.     A.    Syntaxe
  28.     B.    Les options
  29.   V)    BUGS
  30.   VI)    PROBLEMES
  31.   VII)    MON ADRESSE
  32.  
  33. ****************************************************************************
  34.  
  35.  
  36. I) CE QU'EST PUBSELECT
  37.   PubSelect permet de choisir l'écran sur lequel s'ouvriront les fenêtres
  38.   de tel ou tel programme. Il peut être contrôlé à partir du CLI ou du WB,
  39.   grâce à un AppIcon. Il ne tourne qu'à partir du WB2.0.
  40.  
  41. II) SUR CETTE DOCUMENTATION
  42.  
  43.   Cette documentation est écrite pour être utilisée par un afficheur de
  44.   textes, comme More. Les références sont donc données sous forme de mot-clé
  45.   à chercher dans le texte. Ces mots-clés sont entre parenthèses et entre
  46.   guillements.
  47.   Exemple : ("II) SUR CETTE DOCUMENTATION")
  48.  
  49. III) UTILISATION DE PUBSELECT
  50.  
  51.   A. Installation
  52.     Double-cliquez sur le programme d'installation ou, ceci copiera
  53.     reqtools.library dans votre répertoire LIBS:.
  54.  
  55.     Copiez ensuite ExePub dans votre répertoire c: ou un répertoire
  56.     équivalent.
  57.  
  58.     Je vous conseille de mettre PubSelect dans votre répertoire WBStartup,
  59.     mais vous pouvez le démarrer quand vous voulez.
  60.  
  61.   B. Les options
  62.  
  63.     - A partir du Workbench
  64.       Les options sont définies dans le champs ToolTypes du programme.
  65.       Pour les modifier, sélectionnez l'icone du programme puis le menu
  66.  
  67.     Icon
  68.     Informations...
  69.  
  70.       Ces options sont sous la forme de :
  71.     NOM=ARGUMENT
  72.  
  73.     - A partir du CLI
  74.       La syntaxe est :
  75.     > PubSelect ?
  76.       ou
  77.     > PubSelect [-opt1] [-opt2] [-opt3] [...]
  78.  
  79.       Le premier appel cause l'affichage d'un message d'aide, suivit des
  80.       différentes options.
  81.       Le second lance réellement le programme.
  82.  
  83.       Un option commence toujours par le signe "-", suivit par une lettre
  84.       indiquant la nature de l'option.
  85.       Lorsque une option à besoin d'un argument, cet argument peut être
  86.       accolé à l'option ( ex : -nSelect ) ou être placé directement après
  87.       (ex : -s "Les sélections" )
  88.  
  89.       Exemples :
  90.     > PubSelect -n OpenOn -w CON:0/640/256/Tools/AUTO/WAIT/CLOSE
  91.     > PubSelect -*
  92.     Cet appel oblige PubSelect à utiliser les options définits à
  93.     partir du Workbench.
  94.  
  95.     - Toutes les options
  96.  
  97.       - ICON    'i'
  98.       - NAME    'n'
  99.     Ces options permettent de modifier l'icone de PubSelect affichée
  100.     dans la fenêtre workbench. L'option ICON définit l'image de
  101.     l'icone et NAME le nom affiché au-dessous.
  102.  
  103.     ICON doit être suivit du chemin complet d'un fichier info SANS
  104.     l'extension .info ou des mots-clé DEFAUT et PROGRAMME. DEFAUT
  105.     demande l'image par défaut, celle qui est utilisée si l'option
  106.     n'est pas spécifiée. PROGRAMME indique que l'icone de PubSelect
  107.     doit être utilisée.
  108.  
  109.     NAME doit être suivit du nom à afficher, OnPubScreen par défaut.
  110.  
  111.     WB :
  112.       ICON=icons:PubSelect
  113.       NAME=OpenOn
  114.  
  115.     CLI :
  116.       -i PROGRAMME
  117.       -n OpenOn
  118.  
  119.       - WINDOW    'w'
  120.     Ceci définit la fenêtre utilisée pour les outils démarrés comme
  121.     sous CLI. Par défaut, PubSelect utilise une définition similaire
  122.     à celle du Workbench.
  123.  
  124.     Cette fenêtre peut être n'importe quel gestionnaire de console,
  125.     un fichier quelconque ou NIL:.
  126.  
  127.     WB :
  128.       WINDOW=NIL:
  129.  
  130.     CLI :
  131.       -w NIL:
  132.  
  133.   C. Utilisation
  134.     Une fois PubSelect démarré, l'icone voulue est affichée dans la fenêtre
  135.     workbench. Glissez des icones de type TOOL ou PROJECT dessue, elles
  136.     démarreront comme si vous aviez double-cliqué dessus. Vous pouvez
  137.     glisser plusieurs icones sur PubSelect ; il réagira comme le Workbench.
  138.  
  139.     Avant que l'outil démarre, PubSelect ouvre une fenêtre contenant la
  140.     liste des écrans publics. Choisissez-en-un en double-cliquant dessus
  141.     ou en cliquant sur Ok après l'avoir sélectionné. Si vous appuyez sur
  142.     Défaut, l'écran public par défaut sera utilisé. L'effet est le même
  143.     qu'avec l'option SHANGHAI.
  144.  
  145.     Une fois que l'outil à démarré, toutes les fenêtres de cet outil
  146.     qui devraient s'ouvrir sur le workbench ou sur l'écran public par
  147.     défaut s'ouvriront sur l'écran que vous avez choisi.
  148.  
  149.   D. Quitter PubSelect
  150.     Pour mettre fin au programme, double-cliquez sur l'icone de PubSelect
  151.     puis sélectionnez l'option Quitter. Elle est parfois absente, si des
  152.     programmes WB tournent encore.
  153.  
  154.     Vous devrez ensuite confirmer votre choix, car quitter ce programme peut
  155.     être dangereux. En effet PubSelect patche (SetFunction()) des fonctions
  156.     de la bibliothèque intuition. Si un autre programme démarré après
  157.     PubSelect à mis également sa propre fonction sur une de celles patchées
  158.     par PubSelect, il peut y avoir plantage.
  159.  
  160.     Voyez le chapitre BUGS pour connaître les fonctions patchées.
  161.  
  162. IV) UTILISATION D'EXEPUB
  163.     ExePub permet de faire démarrer un programme comme PubSelect mais
  164.     à partir un CLI. PubSelect doit être actif pour pouvoir utiliser
  165.     ce programme.
  166.  
  167.     A.    Syntaxe
  168.  
  169.       Voila ce qu'affiche ExePub lorsque vous entrez
  170.       >ExePub ?
  171.  
  172.     ExePub version 1.0 par Stéphane Zermatten
  173.     Doit être utilisé seulment avec PubSelect.
  174.  
  175.     USAGE : ExePub [-w] [-s ScreenName] Command [Arg1] [Arg2] ...
  176.         ExePub -q
  177.         ExePub -?
  178.  
  179.     OPTIONS : -w    Démarre comme un outil WB
  180.           -s    Spécifie le nom de l'écran public à utiliser
  181.           -q    Quitter PubSelect
  182.           -?    Afficher des informations sur ExePub
  183.  
  184.     B.    Les options
  185.        -w
  186.       Avec l'option -w, la commande est démarrée comme si vous aviez cliqué
  187.       dessus. Tout les noms suivant doivent être des fichiers qui seront
  188.       liées au programmes démarré. (Multisélection)
  189.  
  190.       Sans cette option, la ligne est ensuite passée au CLI. Attention,
  191.       les commandes résidentes ne sont par reconnues (de toute façon,
  192.       elles ouvrent rarement des fenêtres) et les outils ne sont pas
  193.       recherchés dans la liste Path.
  194.  
  195.        -s
  196.       Si vous n'utilisez pas l'option -s, la fenêtre de sélection
  197.       s'affichera.
  198.  
  199.        -q
  200.       Cette option doit toujours être utilisée seule. Elle ordonne à
  201.       PubSelect de s'arrêter, ce qu'il fait quand c'est possible.
  202.  
  203. V) BUGS
  204.   Les fenêtres ouvertes par un gestionnaire de console comme CON: échappent
  205.   au contrôle de PubSelect, car c'est la tâche du gestionnaire qui ouvre la
  206.   fenêtre et non la tâche appelante.
  207.  
  208.   Les programmes qui se détachent eux-mêmes du CLI qui les a lancé ne sont
  209.   incontrôlables par PubSelect car ils démarrent ensuite leur propre tâche.
  210.   Ce genre de programmes fonctionne normalement quand ils est lancé depuis
  211.   le workbench.
  212.   Un des programmes les plus impossibles est AZ de JM Forgeas. Je ne vois
  213.   pas comment contrôler l'ouverture ses fenêtre avec le système actuel de
  214.   PubSelect.
  215.  
  216.   Il peut y avoir des problèmes avec d'autres programmes à cause des patches
  217.   sur certaines fonctions intuition.
  218.   Ces fonctions sont :
  219.    Intuition    LockPubScreen()
  220.    Intuition    GetDefaultPubScreen()
  221.    Intuition    WBenchToBack()
  222.    Intuition    WBenchToFront()
  223.    Intuition    OpenWorkbench()
  224.    Intuition    CloseWorkbench()
  225.    Intuition    GetScreenData()
  226.    Intuition    OpenWindow()
  227.    Intuition    OpenWindowTagList()
  228.  
  229.   Si vous trouvez d'autres bugs, faites le moi savoir. Envoyez-moi une
  230.   lettre avec les circonstances dans lequels apparaît ce bug et les
  231.   programmes que vous utilisez et qui peuvent interférer avec PubSelect.
  232.  
  233. VI) PROBLEMES
  234.   Si PubSelect refuse de démarrer sans vous dire pourquoi, c'est que la
  235.   bibliothèque reqtools manque. ("A. Installation")
  236.  
  237. VII) PROJETS FUTURS
  238.   Je pense écrire un programme similaire à PubSelect. Il attacherait des
  239.   programmes, grâce à leur nom, à tel ou tel écran. Ce nom pourrait
  240.   comporter des wildcards. (Mais si , les trucs comme #? et ram:(Premier|%))
  241.   Ceci résoudrait le problème d'AZ.
  242.  
  243. VIII) MON ADRESSE
  244.  
  245.   Stéphane Zermatten
  246.   1958 St-Léonard
  247.   Suisse
  248.  
  249.